<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Strict//EN">
<html>
<head>
<meta http-equiv="Content-Language" content="en-us">
<title>IupGLLabel</title>
<link rel="stylesheet" type="text/css" href="../../style.css">
<style type="text/css">
.style1 {
	font-size: large;
}
</style>
</head>
<body>
<div id="navigation">
  <ul>
    <li><a href="#Creation">Creation</a></li>
    <li><a href="#Attributes">Attributes</a></li>
    <li><a href="#Callbacks">Callbacks</a></li>
    <li><a href="#Notes">Notes</a></li>
    <li><a href="#Examples">Examples</a></li>
    <li><a href="#SeeAlso">See Also</a></li>
  </ul>
</div>

<h2>IupGLLabel <span class="style1">(since 3.11)</span></h2>

  <p>
  Creates an embedded OpenGL label interface element, which displays a text and/or an image. It 
  inherits from <a href="iupglsubcanvas.html">IupGLSubCanvas</a>. It exists only 
  inside an
<a href="iupglcanvasbox.html">IupGLCanvasBox</a>.</p>

<h3><a name="Creation">Creation</a></h3>
<pre>Ihandle* IupGLLabel(const char *<strong>title</strong>); [in C]
iup.gllabel{[title = <strong>title</strong>: string]} -&gt; (<strong>elem</strong>: ihandle) [in Lua]
gllabel(<strong>title</strong>) [in LED]</pre>
  <p><b>
  title</b>: Text to be shown on the label. It can be NULL. It will set the 
  TITLE attribute.</p>
  <p>
  <u>Returns:</u> the identifier of the 
  created element, or NULL if an error occurs.</p>

<h3><a name="Attributes">Attributes</a></h3>


<p>The 
  <strong>IupGLLabel</strong> element handle all attributes defined for a
<a href="iupglsubcanvas.html">IupGLSubCanvas</a> control.</p>
<blockquote>
  <hr>
</blockquote>



<p><b>ALIGNMENT</b> (<font size="3">non inheritable</font>): horizontal and 
vertical alignment. Possible values: &quot;ALEFT&quot;, &quot;ACENTER&quot; and &quot;ARIGHT&quot;,&nbsp; 
combined to &quot;ATOP&quot;, &quot;ACENTER&quot; and &quot;ABOTTOM&quot;. Default: &quot;ALEFT:ACENTER&quot;. Partial 
values are also accepted, like &quot;ARIGHT&quot; or &quot;:ATOP&quot;, the other value will be 
obtained 
from the default value. </p>

  <p><a href="../attrib/iup_fgcolor.html">FGCOLOR</a>: Text color. Can have an 
  alpha component. Default: &quot;0 0 
  0&quot;.</p>


  <p><strong>IMAGE</strong> (<font SIZE="3">non inheritable</font>):
  Image name. Use
	<a href="../func/iupsethandle.html">IupSetHandle</a> or
	<a href="../func/iupsetattributehandle.html">IupSetAttributeHandle</a> to 
	associate an image to a name. See also
	<a href="../elem/iupimage.html">IupImage</a>.</p>
<p><strong>IMAGEHIGHLIGHT</strong> (<font SIZE="3">non inheritable</font>): 
Image name of the element in highlight state. If it is not defined then the 
IMAGE is used.</p>
  <p><strong>IMAGEINACTIVE</strong> (<font SIZE="3">non inheritable</font>): 
  Image name of the element when inactive. If it is not defined then the IMAGE 
  is used and its colors will be replaced by a modified version creating the 
  disabled effect. </p>

  
<p><strong>IMAGEPRESS </strong>(<font size="3">non inheritable</font>): Image 
name of the element in pressed state. If it is not defined then the IMAGE is 
used.</p>

<p><strong>IMAGEPOSITION </strong>(<font size="3">non inheritable</font>): 
Position of the image relative to the text when both are defined. Can be: LEFT, 
RIGHT, TOP, BOTTOM. Default: LEFT.</p>

  
<p><b>PADDING</b><strong> </strong>(<font size="3">non inheritable</font>): 
internal margin. Default value: &quot;0x0&quot;.</p>


<p><strong>CPADDING</strong>: same as PADDING but using the units of the <strong>
	SIZE</strong> attribute. It will actually set the PADDING attribute. (since 
3.29)</p>


<p><strong>SPACING </strong>(<font size="3">non inheritable</font>): defines the spacing between the 
image and the title. Default: &quot;2&quot;.</p>

  
  <p><strong>CSPACING</strong>: same as SPACING but using the units of the 
  vertical part of the <strong>
	SIZE</strong> attribute. It will actually set the SPACING attribute. (since 
  3.29)</p>

  
  <p><a href="../attrib/iup_title.html">TITLE</a> (<font SIZE="3">non inheritable</font>): 
	Label's text. The '\n' character is accepted for line change.</p>

  

<h3><a name="Notes">Notes</a></h3>


<p>The <strong>IupGLLabel</strong> can contain text and image simultaneously. 
</p>
<p>The natural size will be a combination of the size of the image and the 
title, if any, plus PADDING and SPACING (if both image and title are present).</p>


<h3><a name="SeeAlso">See Also</a></h3>

<p><a href="../elem/iupimage.html">IupImage</a>, <a href="iupglbutton.html">IupGLButton</a>, <a href="iupgltoggle.html">IupGLToggle</a>.</p>


</body>

</html>